home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / MorphOS / Epic4_mos / share / epic / help / 6_functions / eof < prev    next >
Encoding:
Text File  |  2002-10-28  |  600 b   |  22 lines
  1. Synopsis:
  2.    $eof(<file descriptor>)
  3.  
  4. Technical:
  5.    This function tests whether the client is currently at the end of the
  6.    file pointed to by the given file descriptor.  The only valid input is
  7.    a file descriptor returned by the $open() function.
  8.  
  9. Practical:
  10.    This function is used to see if the end of a file has been reached.
  11.    This is mostly useful while reading a file, such that it can be closed
  12.    once the end is reached.
  13.  
  14. Returns:
  15.    -1   error, no such file descriptor
  16.     0   not at end of file
  17.     1   end of file reached
  18.  
  19. See also:
  20.    close(6); open(6); read(6)
  21.  
  22.